phin
Advanced tools
Package description
The phin npm package is a lightweight HTTP client designed for simplicity and minimalism. It is used for making HTTP requests from Node.js environments. It supports promises and can handle various types of requests such as GET, POST, and more.
Simple HTTP GET requests
This code sample demonstrates how to perform a simple HTTP GET request to a specified URL using phin.
const phin = require('phin')
phin('https://example.com', (err, res) => {
if (err) throw err
console.log(res.body)
})HTTP POST requests with JSON
This code sample shows how to perform an HTTP POST request with JSON data using phin.
const phin = require('phin')
const options = {
url: 'https://example.com/post',
method: 'POST',
headers: {'Content-Type': 'application/json'},
data: { key: 'value' }
}
phin(options, (err, res) => {
if (err) throw err
console.log(res.body)
})Promisified HTTP requests
This code sample illustrates how to use phin with promises to make asynchronous HTTP requests.
const phin = require('phin').promisified
async function makeRequest() {
try {
const res = await phin('https://example.com')
console.log(res.body)
} catch (err) {
console.error(err)
}
}
makeRequest()Axios is a popular HTTP client for the browser and Node.js. It supports promises by default and has a wide range of features including interceptors, automatic transforms for JSON data, and client-side protection against XSRF. It is more feature-rich compared to phin but also larger in size.
Got is another HTTP request library for Node.js that is designed to be more user-friendly and powerful than the built-in http module. It supports streams, advanced timeout handling, and instances with custom defaults. It is more comprehensive than phin but also more complex.
node-fetch is a light-weight module that brings the Fetch API to Node.js. It aims to provide a consistent API with the browser's fetch function. It is similar to phin in terms of simplicity but follows the Fetch API standards.
Superagent is a small progressive client-side HTTP request library. It has a fluent API that allows chaining of methods to configure requests, and it can be extended with plugins. It is more feature-rich than phin and has a different API design focused on chaining methods.
Readme
The ultra-lightweight Node.js HTTP client
Full documentation | GitHub | NPM
const p = require('phin')
p('https://ethanent.me', (err, res) => {
if (!err) console.log(res.body)
})
npm install phin
phin is trusted by some really important projects. The hundreds of contributors at Less, for example, depend on phin as part of their development process.
Also, phin is super lightweight. Like 99.8% smaller than request lightweight. To compare to other libraries, see phin vs. the Competition.
Simple POST:
p({
url: 'https://ethanent.me',
method: 'POST',
data: {
hey: 'hi'
}
})
Promisified:
const p = require('phin').promisified
;(async () => {
const res = await p({
url: 'https://ethanent.me'
})
console.log(res.body)
})()
Simple parsing of JSON:
// (In async function in this case.)
const res = await p({
url: 'https://ethanent.me/name',
parse: 'json'
})
console.log(res.body.first)
phin has util.promisify support. The promisified library can also be accessed with require('phin').promisified!
phin is super lightweight, and it's getting lighter all the time.
It contains all of the common HTTP client features included in competing libraries!
| Package | Size (KB) | Dependencies (Tree Count) | Size Comparison (vs. phin) |
|---|---|---|---|
| request | 4,446 | 53 | 444.6x |
| superagent | 1,235 | 24 | 123.5x |
| got | 664 | 44 | 66.4x |
| snekfetch | 107 | 0 | 10.7x |
| phin | 10 | 0 | 1x |
FAQs
The ultra-lightweight Node.js HTTP client
The npm package phin receives a total of 1,131,864 weekly downloads. As such, phin popularity was classified as popular.
We found that phin demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Product
Socket now supports four distinct alert actions instead of the previous two, and alert triaging allows users to override the actions taken for all individual alerts.
Security News
Polyfill.io has been serving malware for months via its CDN, after the project's open source maintainer sold the service to a company based in China.
Security News
OpenSSF is warning open source maintainers to stay vigilant against reputation farming on GitHub, where users artificially inflate their status by manipulating interactions on closed issues and PRs.